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LNBUG 6 500 DEVELOPMENT MONITOR 

INTRODUCTION: The MCS6500 Development Monitor is a 

^SHjiFehenslve debug package including.complete list 
and modify commands, mini-assembler/disassembler, 
disc and tape communications, stepping, trace, and 
breakpoint capabilities, and other useful memory 
manipulation commands. The program is designed.to 
run on an S-100 type computer utilizing an Atari 
trace memory interface board with a video or ar 
copy terminal. 

To run the monitor, the system must be configured 
as follows: 

1 - Atari GVA-2503 CPU card 

1 - Dynabyte 16K RAM card 

1 - Cromemco 16K ROM card 

1 - Atari GVA-2504 Trace Memory Interface Card 

Make sure to set switches as specified on sheet_labeled 
"DEVELOPMENT SYSTEM SWITCHES." A copy of this is in 
eluded at the back of this manual. 

With the BOOTSTRAP switch on, the monitor will 
be entered upon reset, starting at location 6000. 

If reset is desired to clear vectors and reset 
all monitor cells, a carriage return should be the 
first character entered. If a "warm" reset is e 
sired, hit any other key. The monitor will echo 

"NOW ENTERING LNBUG #X" 

to indicate the entry to the monitor and the version 
being used. 

After a "cold" reset, the user must select the 
control set for the terminal being used: 

Type "D" CCR)* for a Digilog terminal. 

Type "H" <CR> for a hard copy terminal. 

For Lear Siegler, type nothing. 

The monitor is now ready for operation. 



BA SIC COMMAND FORMAT : 

Commands to the monitor are entered in a line 
at a time in the deferred mode or with a single key¬ 
stroke in the immediate mode. 

The command and the optional suffix are always 
entered in after necessary address and data entries. 

Examples: 

Format Example. 


Command Suffix 
Adr Command Suffix 
Adrl.Adr2 Command Suffix 
Adrl.Adr2, Data Command 
Adr1.Adr2, Adr3 Command 


DX 

1000/Q 
1000.1100/Q 
1000.1100,00 # 
1000.1100,100m 


"Adrl.Adr2" indicates start and stop addresses.. 

"Adr3" indicates destination address, "Suffix" is. 
always optional. "Deferred" commands.are line ori¬ 
ented and all key entries are stored in.a.buffer un¬ 
til <CR> is hit. The buffer can be modified prior 
to execution using various key buffer operators. 


COMMAND DESCRIPTIONS ; 

The following descriptions are organized into 
the following groups: 

List and Modify Memory 

Macro Memory Operators (Move, Verify, etc.) 

Patching Command 

Program Loading and Saving 

Key Buffer Operators 

Functions for Running Programs 

Suffixes 

Relocation Register 

Terminal Control 

In the following descriptions, Mode "D" is the 
deferred mode and "I" is the immediate mode. (See 
descriptions above.) All values are in hexidecimal. 
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/ 


LI ST AND mod ifY: 

Com mand Mode Description 

R 1 Display user CPU registers . 

EX: User types- R 

Monitor prints: 

PC-2000 P=00 A=01 X=FF Y=FF S =EA 


/ 


D 


ff 


/ 


M_stmemor^ from start to stop address. Or, 

up to a the a next S aaa nly iS s P ecified ' ^11 locations 
be listed. address increment of sixteen wil-l 

— User types- W.108/ (echoed) 

Monitor prints after return: 


#123456789 

1000 — AA 00 A9 11 01 FF 21 BC C9 
EX2p User types- 100&/ (echoed) 
Monitor prints after return: 

^ 1 2 3 4 . 56789 


A B C D E 


abode 


B9 01 21 C9 00 D0 


100A = 

EX3l User types- 2000.2006/Q (echoed) 

Monitor prints after return: 

2000 LDA I, 0FF 
2002 STA Z,10 

2004 DEX 

2005 BNE 2028 

When no address is specified, list the next sixteen 
locations starting from the last list address plus one 
Allows convenient continuous listing. 

EXp User types- / (not echoed) 

Monitor prints: 

10!0 — AA 99 24 32 ,7D A9 C0 0D (etc.) 


i 
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LIST AND MODIFY (continued) 

Command Mode Des cription 
SHFT / I List one locatio n. 

EX: 1000/ (echoed) 

Monitor reprints line on shift /: 

1000 = A9 

A repeat of just the shift / prints: 
1000 = A9 again 

(This is useful for reading PIA ports) 


D Modify memory . Opens memory for modification 
starting at specified address. Memory is not 
actually modified until carriage return is hit 
or until address passes over an increment of 
sixteen. (Automatic carriage return for con¬ 
tinuous entry.) All key buffer operators can be 
used. (Rub, escape, etc.) 

EXl: User types- 1000: (echoed) 

Monitor prints: 

0 1 2 3 4 5 6-7 8 9 A B C D E F 

1000 = 

The cursor is then positioned under " 0 " waiting 
for a user entry. 

EX2: User types- 1000: (echoed) 

Monitor prints: 

1000:Q 

The monitor is now waiting for the user to enter 
in mnemonics. 
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LIST AND MODIFY (continued) 


Command 


SHFT: 


Mode Desc r iption - 

I Modify memory starting at start of prior listing. 
Or , modify user CPU registers if "R" command pre¬ 
ceded command. All other characteristics are 

identical to ":" in the deferred mode. 

EX: User types- 1000/ 

Monitor prints locations 1000-100F as shown above. 
User then types / (not echoed) 

Monitor prints: 

1000 : 

The monitor is now waiting for user entry. 

I M odify one location . Immediate modification of 
one location. 

EX: User types- SHFT: 


Monitor prints: 

1000 : 

Only this one location will be modified and 
address location pointer is not incremented. 


D Macro Listing Command . A macro listing command used 
during trace or under user control. Up to six single 
locations or lists (of any length) can be specified 
and then listed either during breakpoint/step opera¬ 
tion or when "K <(CR^ " is specified. To set these, 
specify: Adrl.Adr2 - List, Adrl - Single location. 

Separate with commas, and end line with "K <CR> 

Any number of entries (up to six) are allowable and 
can be in any order. The "X" suffix clears the "K" 
directory. 

EX: User types- 00.0F , 4094,4021K 


When a breakpoint occurs in a user program, or if 
the user types in "K <CR> ", the monitor 'will print: 

12 3 4 5 6 7 8 9ABCDEF 
0000 = AA 10 00 00 FF 00 10 01 11 AC C9 F0 D0 00 00 
4094 = 21 
4021 = A2 

Note that if trace mode is set, the listing will be 
made after every breakpoint, whereas, if the trace 
mode is not set, the listing will be made after 
passing through the breakpoints "N" times as set by 
the "N" command. 
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macro m emory operators ^ ^ 

Command Mode Description 


M 


D 


D 


Mnv« ».orY «™ atarl fSr S a°reSior?f l ° 

S“vfnf S^*SSS^ i» overlapping 

moves. 

EXi User types- 1 JW-10FF, 1003M 
Monitor then moves block up three bytes. 

and n storadlrIsses°and'des- 

tination address (Byte-Saver^addr J • ^ with _ 

number of b V e ® “ the program always mam- 

°tSn“r?=S=f»“««*C?cl2- to prevent 
damage to the PROM. 


EX: User types- 


1000. 13FF ,80001 


Programs RAM area to l3FF to the PROM 

located at 8000. 

Monitor then prints: 

IS°PROGRAMMER* UNPROTECTED * READY? 

for no?" Yefstfrts thfprograier/no returns 
_+ i +-rh -hhfi monitor. 


V 


D 


Compare me mory . Compare 
another. Specify start 
block and start address 


ne block of memory with 
d stop addresses of one 

l ^ ^ V 4- Ac checked (Adr^j 


For example, 
struction. 


see move 


instruction and verify in 


D 


Verifi_^roEer^|or^E|r||^ h^rent^ontentshor 
" AA " destructiv^checking. Specify start and stop 


AA 
non 
addresses 


EX 


User types- 2000.3000V 


Monitor prints 


First error 2400 
Total errors = 1024 
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MACRO MEMORY OPERATORS (continued) 


Command Mode Description 

# D Fill memory with specified data byte , starting 

at Adr1 and - ending at Adr2. 

EX: 1000 •1FFF ,00# will set locations 1000 to 

* 1FFF with "00." 


Z 


D De lete all memory . 
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PATCHING COMMAND 

Command Mode Description 




I 


D 


Insert patch in program. Allows user to 
specifyan address in the program under develop¬ 
ment and insert instructions at this address 
without affecting the rest of the program. The 
monitor actually places the patched code in a 
"Patch Area" and inserts a "BRK" at the user 
program address upon starting the program.. 
Utilizing a "Patch Directory," the monitor is 
able to vector the user program to the proper 
patch in the patch area upon encountering a 
"BRK." The patch has already been constructed 
automatically to jump back to the user program. 

EX: 



User 

Program 

1000 

LDA 1,00 


1002 

STA ZX,03 


100 4 

DEX 


1005 

BNE 1000 


Insert "DEY" at 

1002 . 

Patch 

area: 


40A6 

DEY 


40A7 

STA ZX,03 

Added automatically 

40A9 

JMP 1004 

by patch program 

Or, insert "BPL 

1010" at 1005 

Patch 

area: 


40C6 

BMI 40CB 


40C8 

JMP 1010 

This structure automatically 

40CB 

BEQ 40D0 

constructed by patch program 

40CD 

JMP 1000 


40D0 

JMP 1007 



Note that upon return to monitor, all "BRK" 
instructions are replaced with the original in¬ 
struction making the patch transparent upon 
listing. 

Eight blocks of 32 bytes each are maintained 
in the patch area. Thus, a maximum of eight 
■patches can be made. If a patch consumes more 
than 32 bytes, it will automatically link it¬ 
self to the next patch area block provided the 
block is free. 


A patch is specified by entering in the address, 
the desired patch number (optional - automatically 
finds available patch), the "I" command, and a 
carriage return. The desired instructions are 
then entered in mnemonics a line at a time. Two 
carriage returns in a row will terminate the patch. 
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PATCHING COMMAND (continued) 

Command Mode Description 

The patch is effectively placed just prior - 
to the address specified. Note that this 
type of patch consumes an average of 100-200 
processor cycles and should not be used in 
time critical operations. 

IX D "AdrIX" deletes that patch. 

"0,Patch#IX" also deletes one patch. 

EX: 0,4IX deletes patch #4 

"IX" deletes all patches 

LISTING & SAVING PATCHES 

"I" lists patch directory for reference use. 

To save patches and breakpoints, write loca¬ 
tions 8064-81A5 to the disk or tape. Note 
that this will also store the user's zero 
page locations 00-03, the trace mode, reloca 
tion register, and step counter. DO NOT 
RECORD this section while in step mode. Al¬ 
ways load this section before setting step 
mode. 

PATCH & BRKPNT WARNING:. If a location that is a patch is 

modified, that patch will be deleted from 
the patch directory. But, if the location 
is changed to a 00, the old patch code will 
be replaced and the patch maintained, even 
though the program will not run correctly. 
Care should be taken when modifying patched 
code. References to patches here also apply 
to breakpoints. 
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PR OGRAM L OADING /S AVING 
Command Mode Description 

p D Loads data from terminal in the standard . 

MOS TechnoTogy~LOAD format. Returns con¬ 
trol to monitor upon receipt of an ASCII 
DC3 (Control X-Off). No address is specified 
Note that tapes made with this monitor con¬ 
tain the "L," <CR> and DC3, so loading is 
done by simply turning on the tape. Echoes 
on terminal if trace mode is set. 


W D Write hex to terminal in standard MOS Tech¬ 

nology format. Specify start and stop ad¬ 
dresses in the usual fashion. Note that 
an "L," <CR> and DC3 are transmitted at the 
proper times to allow simple reloading. 


KEY BUFFER OPERATORS 


RUB 

I 

Delete Last Entry. Rubout - erase last 
entry. On Lear Siegler, underscore.is 
equivalent; i.e., shift is not required. 

Line Feed 

I 

Non-Destructive Advance. Advance one ad- 
dress or one instruction (in mnemonics mode) 
if first entry of line, or one character in 
any other mode. Does not affect contents 
of buffer or memory. This should be used 
only to skip a previous entry. Space should 
be used initially if skips are desired. 

Space 

I 

Delete Current Entry and Advance. Erase 
previous key entry and advance one address 
if modifying memory in hex mode. Otherwise, 
print non-functioning space character. 

Backspace 
(Control H) 

I 

Back Up One Address. 

Escape 

I 

Delete and Escape Current Line. 

CR 

I 

Execute Current Line. . 
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FUNCTIONS FOR RUNNING PROGRAMS 


Command 

G 


P 

S 

T 


N 


Mode Description 

D Go From Start of Program . "GO" starting 
either at specified address or at address 
specified in previous GO command if no ad¬ 
dress is specified, (for restarting program). 

EX: First Pass: 1000G 

Starts program at 1000. Thereafter, typing 
only a "G <^CR^ " will start program at 1000. 


Proceed From Current Program Address. (Pro¬ 
ceed from BREAKPOINT, SINGLE STEP, Control C, etc. 


Set single step mode (Use SX to reset to 
continuous mode.) 


D Set trace mode (use TX to reset). Lists 

breakpoint #, CPU registers, next instruc¬ 
tions, and any memory locations as specified 
in K command upon breakpoints or single step. 
Also used to specify an echo upon loading 
programs via the terminal (See "L" command.) 


D Set Number of Steps or Breakpoints . Set 

number of times through breakpoints or sin¬ 
gle step before tracing and returning to 
monitor. Specify any hex number up to "FF." 
Note that "0N" will run continuously. 
Specifying just N with no number defaults 
to 01. 

EX: " 10N <CCR^ " will cause 16 breakpoints 

or steps to run before stopping. 

D Set Breakpoints, List Breakpoints . Specify 
as: ADR,#B where # is the breakpoint number 

(1-8). Specifying 0,#BX will delete that 
breakpoint. BX deletes all breakpoints. 

"B"' only lists breakpoint directory. 

EX: User types- 1004,3B 

Run Program (trace mode set, N=02). 

Monitor prints: 

#3 PC-1004 A=01 X-FF Y-00 S-FA BNE 1000 
#3 PC-1004 A—01 Y-FE Y-00 S-FA BNE 1000 

CAUTION: See warning in "I" instruction about 

modifying location specified as a breakpoint or 
patch. 
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APPENDIX 


ASSEMBLER/DISASSEMBLER FORMAT 


The format for the assembler is identical to that of 
the Atari MAC65 format (excluding symbols) . This assembler 
is a 650#.adaptation of the RT-11 MACRO, written by Dave 
Sheppard of Coin-Op Engineering. 


EX: 


LDA NY ,04 


Mnemonic^ Address\ Operand 

Mode Comma Separator 


Note that the development assembler does not recognize 
symbols and all operands must be in hexidecimal. The "Y" 
relocation suffix can always be specified. Branch in¬ 
struction operands are specified as the absolute (or re¬ 
locatable "Y") address. The offset address is then cal¬ 
culated from this address. 


If an error is detected, the assembler prints the error 
message and then returns the cursor to the beginning of the 
line for re-entry of that line. 


To terminate assembly, hit carriage return without en¬ 
tering any other keys (blank line). 

Address Mode Specification - 


(none) 

Relative, Implied, 
Absolute (Default) . 

I 

Immediate 

A 

Absolute 

Z 

Zero Page 

NX 

(Indirect,X) 

NY 

(Indirect),Y 

ZX ' ’ 

Zero Page,X 

AX 

Absolute,X 

AY 

Absolute,Y 

N 

Indirect 

ZY 

Zero Page,Y 


-A1 - 
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DEVELOPMENT SYSTEM ADDRESS SPACE 



I 


DEVELOPMENT SYSTEM SWITCHES 





Z 2 BOX RESET: POC to complete system. 


TMI- TERM. 


PDP-11 

A15-8 

COLEEN 


Set baud to monitor terminal. Set one (1) 
switch only for desired rate. 

Set baud rate for 2nd serial channel. 

Address decode of 2 serial channels. 

Set for D7 negative logic- AL5 A14 A13 Al2 All 

AlJ A9 A8 




PROCESSOR 

RESET 

1 MHZ 

2 MHZ 
EXT.CLK. 

JOLT/PROM 

BOOTSTRAP 
Bus DISC. 
W.D. DISABLE 


COLEEN PROC. 
TRACE MEMORY 

16K SYSTEM ; 

DYNABYTE RAM 


BANK SELECT 
WRT PROT 
BANK 3 &4 
BANK 1&2 

32K SYSTEM: 


Local reset to processor and associated TMI. 
Selects processor clock. 

Use only one switch at a time. (ON=SELECT) 

Selects one of two address decode maps- 
(ON=J OLT, OFF=LNBUG) 

Enables power-on remapping of 7FFF to FFFF. 
(force A15 low on reset if switch is on) 
Enables processor to system buss vs. stand 
alone (ON^normal, OFF^disconnect) . 

Kills a .1 ps hardware watchdog reset. 
(ON=DISABLE WATCHDOG) 

W.D., BUS DISC , BOOTSTRAP , JLT, EXT. CLK.,2, T 
W.D., BUS DISC, BOOTSTRAP, JLT, EXT. CLK.,2,1. 


1-8 open: 9 on 
1-5 open 

1-4,6-8 open: 5, on (Ej2f-FF) 
1 open: 2-8, on (00-1F) 


DYNABYTE: 


Set as above except: 

, BANK 1&2 1,4,8 open 2-3, 5-7 on (8j2f-9F) 

IMS RAM 32K systems only 


J2 

Mem addr 

J1 

J4 

J5 

Addr: 7-6 
5-4 
3-2 
1-0 


uWR 

0 (00-3F) 

on,sp 
8 , 4 , 2,1 
2, sp 
3 
3 
3 

none 
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DEVELOPMENT SYSTEM SWITCHES (continued) 

PRC PROM CARD 

D9-D16 n.c. 

D1-D8 diodes 

WAIT 1-14 jumpered 

Select 2-7,3-6 jumpered 

16K PROM CARD (Cromemco) 

Bank 0-7 off 
OUT off 
A15 off 
DMA off 
A14 on 

Disable ROM's 0-7 
Wait Disable 

TUART optional 

1,3-6,8,10 ON 
2,7,9 OFF 

BYTESAVER optional 

A15-Hi A14-LO Al3-Hi A0-BF 
Wait N.C. 

Protect - Off when programming 


D2 



TERMINAL FORMAT 


The 685j2f serial communications ports are configured 
by software upon reset as follows: 

7 Data bits 
1 Stop bit 
Even Parity 

Baud rate is set by switches on the trace memory 
interface card. Recommended speed when used with TRACE 
MEMORY, 19,200 baud. 




JXrCui^ lo/Wt&sr 

mmn/cmy 

D£i/eioPmENr s'fsfm /idoress map 


0 x x f 

j 

7. 

3 

S X x X 

i 

2i- c static ram 




6 x * x 
?- X x X 

LNSUC? __ 

; &x.pram / g % x X 

7K ZittHC RA*n 

Z7 lb .ZDCKET umu^H 

E A >0 

LPiBUQp IU) i^/sm<&PRDM SOCKET g % X X 

q x x x 
A 

B 

C X X x 


CA«.7Ui£fe£ SPACES /D S X X 

CTLA 


lb 1C SmnCRAM / D v 3 XX 

, / D % X A 

UMU5LD 

A fin O /c { ^u^pj> 

I) X X X 

I/O SPPICt - . D V? X X 

UK“3U> /lnbug> acm’5 ^ 

E X X X 
F X X X 

7 

' 

PCSlDf XT' fVI QTITCfV SPACE. \ t) s rt X X 
, gK STATIC RAM \ D *'b X X 

POiCET 

I ! ' 

^ Aa^, 

\ b % K X 
\ D f /r X- X 

Pnt(M;W( foor D7 dc> 

PDP-tl Pc>OJ~ 1>T10 

Plft 

1/HU3LI> 






